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Introduction 


This book describes how to build smart applications using cutting-edge 
technologies like rules engines, code automation frameworks, and natural 
language processing (NLP). 





Note Asmart application is an application embedded with 
intelligence. The intelligence can be updated on the fly. 





This book provides step-by-step guidance on porting nine rules engines 
(CLIPS, JRuleEngine, DTrules, Zilonis, Termware, Roolie, OpenRules, 
JxBRE, and JEOPS) to the mobile platform. Then, it describes how to use 
each rules engine to build a smart application. Sample code snippets are 
provided so that the reader can get started with programming their smart 
application immediately. The book also describes porting issues with other 
popular rules engines (Drools, JLisa, Take, Jess, and OpenRules). 

This book will guide the reader on how to automatically generate an 
working smart application based on requirement specifications. 

This book concludes with showing the reader how to generate a smart 
application from unstructured knowledge using the NLP framework 
Stanford POS (part of speech) tagger. 


PART | 


Rules Engines 


СНАРТЕК 1 


Which Rules Engine 
Is Best for Building 
Smart Applications? 


Let us now evaluate rules engines based on agility, scalability, and usability 
and decide which is best suited for developing smart applications. We'll 
start by defining what a rules engine is. 

Rules engines help embed intelligence into an application. The 
intelligence can be updated on the fly. Readers should be aware of 
programming calculators. Rules engines can be thought of as much more 
sophisticated versions of such calculators. CLIPS can be downloaded from 
Source Forge [24]. 


java -jar CLIPSINI.jar 
CLIPS» (+3 4) 

T 

CLIPS> (defglobal ?*x* = 3) 
CLIPS> ?*x* 

3 

CLIPS> red 

red 

CLIPS> (bind ?a 5) 

5 
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CLIPS» (+ ?a 3) 

8 

CLIPS» (reset) 

CLIPS» ?a 

[EVALUATN1] Variable a is unbound 
FALSE 

CLIPS» 


Sample code is taken from [23]. There are diverse types of rules engines 
written in Java that vary widely in functionality and concept. The revenue 
from business rules engines exceeded $460 million in 2011 [1]. The total 
market size for the mobile application market will be as big as $25 billion 
by 2015 [2]. As per Gartner, developing context-aware mobile applications 
is one ofthe top trends [3]. 

Mobile applications are becoming increasingly complex. This is 
making way for rules engines on mobile platforms. Rules engines can 
help keep business logic separate from application logic. At this point in 
time, not many rules engines are known to work on mobile platforms. We 
have ported and evaluated nine rules engines: CLIPS, OpenRules, JXBRE, 
JEOPS, Roolie, Termware, JRuleEngine, Zilonis, and DTRules in Android. 
This chapter provides a detailed description, step-by-step porting guides, 
and sample working code for each ofthe rules engines. We also discuss 
the issues faced while attempting to port other popular rules engines, 
like Drools, JLisa, “Take,” and Jess. We compared the rules engines based 
on licensing, language used to develop, rules syntax, reasoning method, 
multi-threading support, scalability, and so on in Android [4]. If you are 
trying to use a rules engine in a mobility project, this chapter can save 
more than four staff weeks of effort. 
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What Is a Rules Engine? 


A rules engine is software that executes one or more rules in a runtime 
production environment, and each rules engine has its own proprietary 
rule-storage formats with varying features. Today, rules engines are used in 
domains such as finance, healthcare, retail, manufacturing, and so on. 

Rules engines are becoming increasingly popular for the following 
reasons: 


е Separation of business logic from application 
e Rules can be managed separately from application code. 
e Ease of writing rules for domain experts 


Rules engines allow more flexibility in applications. Applications can 
be rolled out much faster using rules engines. Other advantages include 
understandable rules, tool integration, speed, scalability, and declarative 
programming. 

Android has become the number one mobile platform (Figure 1-1) [5]. 
As the need for context-aware intelligent applications grows, rules engines 
are bound to be integrated into more and more Android applications. 

The main contribution of this chapter is the evaluation of nine rules 
engines on the Android platform. This chapter describes each of the rules 
engines in detail and provides a summary of each. Nine rules engines 
are evaluated and compared against each other for various aspects like 
license, language, rules, reasoning, multi-threading support, scalability, 
and so on. The chapter concludes with our recommendation about the 
rules engine best suited for Android platform. 
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CLIPS 


CLIPS [6] is a rules engine written in C language. It is the most widely used 
rules engine as it is fast and free. 

Itis portable and can easily be integrated with software written in 
C, Java, FORTRAN, and ADA. Wide varieties of complex knowledge can 
be represented using CLIPS rules. The software is available in the public 
domain, making it the choice of the industry. Here is a summary of the 
rules engine (Figure 1-2). 
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FACTS RULES 


P 
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Figure 1-2. CLIPS rules engine 


e License type: Public domain 
e Language: C 

e Works on Android: Yes 

e Rules Syntax: Lisp-like 

e Memory Footprint: 0.83 MB 

e Reasoning Method: Rete [22] 
e Supports multi-threading: No 


e Easy to scale the rules engine: Yes, with average time to 
run being 17.4 milliseconds 


JRuleEngine 


JRuleEngine [7] is a Java-based rules engine that employs a forward- 
chaining algorithm and is designed as per JSR 94 specifications. Rules are 
defined in an XML file. 
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There are two kinds of rules. One is a stateful rules session that 
remembers the state of facts and can be queried repetitively. The other 
is a stateless rules session, which gives good performance but does not 
remember the state of facts. 

The rules engine uses a set of input objects and generates a set of 
output objects. Here is a summary of the rules engine: 


e License type: Open source, LGPL 

е Language: Java 

e Works on Android: Yes 

e Rules Syntax: Condition-action pattern 

е Memory Footprint: 0.062660217 МВ 

е Reasoning Method: Forward-chaining algorithm 
e Supports multi-threading: Yes 


e Easy to scale the rules engine: Yes, with average time to 
run being 0.24163 seconds 


DTrules 


DTrules [8] is a Java-based high-performance rules engine. 

Rules are in the form of decision tables, which provide a simple 
way to describe logic in a tabular form. Unbalanced decision tables are 
supported, which reduces the effort required to build them. DTRules can 
be easily integrated into Java applications. 

It supports domain-specific language (DSL). It has a small memory 
footprint. Here is a summary of the rules engine: 


e License type: Open source (Apache 2.0 Open Source 
License) 


е Language: Java 
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Works on Android: Yes 
Rules Syntax: Decision table 
Memory Footprint: 0.540092468 MB 


Reasoning Method: Uses a structured set of data and a 
set of decision Tables to implement policy rules 


Supports multi-threading: Yes 


Easy to scale the rules engine: No 


Zilonis 


Zilonis [9] is a multi-threaded rules engine. It is based on a variation of 


the forward-chaining Rete algorithm. Its rules representation language 


is similar to LISP. It also provides a scripting environment for Java-based 


applications. 


Here is а summary of the rules engine: 


License type: GPL 

Language: Java 

Works on Android: Yes 

Rules Syntax: Similar to Lisp 
Memory Footprint: 0.683494568 MB 


Reasoning Method: A variation of the forward-chaining 
Rete algorithm 


Supports multi-threading: Yes 


Easy to scale the rules engine in cloud: Yes, with 
average time to run being 0.65863 seconds 
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Termware 


Termware [9] is a rule-processing framework that can be easily embedded 
in Java applications. It has a formal semantic model based on the concept 
of a term system with actions. It allows extreme flexibility in applications 
for high adaptability to a changeable environment, easy re-engineering, 
and component reuse. Here is a summary of the rules engine: 


e License type: Other 

e Language: Java 

e Works on Android: Yes 

e Rules Syntax: Proprietary 

e Memory Footprint: 0.195205688 MB 


e Reasoning Method: One object, many patterns 
matching approach 


e Supports multi-threading: Yes 


e Easy to scale the rules engine: Yes, with average time to 
run being 11.3892 seconds. 


Roolie 


Roolie [11] is an extremely simple Java rules engine. It is a non-JSR 94 rule 
engine designed particularly to use rules created in Java. Basic rules are 
written in separate Java files and are chained together in an XML file to 
create more-complex rules. Here is a summary of the rules engine: 


e License type: Open source LGPL 
е Language: Java 


e Works on Android: Yes 
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e Rules Syntax: XML 

• Memory Footprint: 0.594 MB (608 KB) 
e Reasoning Method: Proprietary 

e Supports multi-threading: No 


e Easy to scale the rules engine: Yes, with average time to 
run being 2.87 seconds 


OpenRules 


OpenRules [12] is a business decision management system (BDMS) that 
provides rules-based application development. It works in a simple Java 
"OpenRules" API or the standard JSR-94 interface. It is used to create 
decision support systems that can be used to create, execute, and maintain 
business rules in applications. Rules are specified in Excel files in the form 
of decision tables, removing the learning part for its users as it just requires 
familiarity with MS Excel. It allows you to change the business rules/logic 
in the Excel sheet at runtime without the need to deploy it again. It supports 
parallelism, enabling it to work in multi-threaded environments. Figure 1-3 
depicts the OpenRules workflow. 
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Figure 1-3. OpenRules rules engine 


12 


Here is a summary of the rules engine: 


License type: Both open source (GPL) and commercial 
(Non-GPL) 


Language: Java 

Works on Android: Yes 

Rules Syntax: Decision tables in Excel files 
Memory Footprint: 2 MB 

Reasoning Method: Proprietary 

Supports multi-threading: Yes 


Easy to scale the rules engine: No 
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JxBRE 


JxBRE [13] is a lightweight Java-based business rules engine (BRE). 

Rules are written in an XML file along with logic defining the flow of the 
application based on the execution of rules. It is both a forward-chaining, 
data-driven inference engine and an XML-driven flow-control engine. 
Here is a summary of the rules engine: 


e License type: GPL 

е Language: Java 

e Works on Android: Yes 

e Rules Syntax: XML 

e Memory Footprint: 1.44 MB (1474 KB) 
e Reasoning Method: Proprietary 

e Supports multi-threading: No 


e Easy to scale the rules engine: Yes, with average time to 
run being 2.57 seconds 


JEOPS 


JEOPS [14] is a Java-based rules engine for embedding forward-chaining 
production rules into Java applications. It provides artificial intelligence 
capabilities to the application. 

JEOPS production rules can be written in a text file (.rules file). The 
interaction with the knowledge base is performed by four methods, 
Tell (object), Flush (), Retract (object), and Modified (object). The time 
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required for Java programmers to learn JEOPS is minimized by its using 
Java expressions in the rule definitions. Here is a summary ofthe rules 
engine: 


e License type: Open Source LGPL 
e Language: Java 
e Works on Android: Yes 


e Rules Syntax: “Condition-action” patterns in any text 
editor 


e Memory Footprint: 0.03 MB (31.5 KB) 
e Reasoning Method: RETE 
e Supports multi-threading: No 


e Easy to scale the rules engine: Yes, with average time to 
run being 120ms 
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СНАРТЕК 2 


Steps to Port Rules 
Engines 


This chapter will cover how to port major rules engines in android 
platform. 


CLIPS 


Android-ndk and Eclipse Helios were used to port CLIPS into Android. It is 
better to use a Linux machine for porting. Here are the steps to port CLIPS 


into Android: 


e Download CLIPSJNI source code from Source Forge 
and build an Android library project from the 
source code. 


e Export the library project to CLIPSJNI. jar. 


e Create a dummy Android project and create a JNI 
directory under your project directory. 


e Copy all source (*.с) and header (*.h) files from CLIPS 
to JNI directory. 


e Add all source files except main.c in Android.mk. 


© Chinmoy Mukherjee 2018 
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e Your Android.mk should look like the following: 


LOCAL_PATH := $(call my-dir) 
include $(CLEAR VARS) 
LOCAL_MODULE :- CLIPSJNI 
LOCAL SRC FILES := agenda.c \ 
analysis.c \ 

argacces.c \ 


CLIPSJNI Environment.c 
LOCAL LDLIBS := -lm -llog -ljnigraphics 
include $(BUILD SHARED LIBRARY) 


e Search for setlocale function in JNI directory. 
Wherever setlocale is expected to return a value, 
hardcode it to C and comment out all other setlocale 
calls, as Android's setlocale returns a hard-coded 0! 


e Comment out main function (just to be on the safe 
side). 


• Runndk-build -b. 


e Copy libCLIPSJNI.so to libs/armeabi and libs/ 
armeabi-v7a. 


e Add CLIPSINI. jar to your Android project as an 
external jar. 
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JRuleEngine 


Here are the steps to port JRuleEngine into Android: 


Download jsr172. jar. 


e Remove all packages from this jar file except 
java.rmi. 


Repackage the jar using jarjar.jar utility as follows: 


e Create rulefile.txt containing the following line: 
rule java.rmi.** 
com. <yourcompany>. јама.тті.@1. 


e Оп соттапа prompt, run java -jar jarjar.jar 
process rulefile.txt <input jar> 
<output jar>. 


Download jsr94-1.1. jar. 

Repackage the jar using jarjar.jar utility. 

e Createarulefile.txt file containing the following 
line: rule java.rmi.** com.«yourcompany». 
java.rmi.Q1. 

е Oncommand prompt гип: java -jar jarjar. jar 
process rulesfile.txt «input jar» «output jar». 


Download Apache Harmony awt. jar and remove all 
java.* packages from the jar. 


Download jruleengine. jar with source code. 


Comment all the else if statements containing а 
Component. getName() function call; also remove the 
import java.awt.Component; statement. 
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• Repackage jruleengine. jar using јагјаг.јаг utility. 
e Create rulefile.txt file containing the following rule: 


e rule java.rmi.** com.<yourcompany>. java. 
rmi.@1 rulejava.awt.Component**org. apache. 
harmony. awt.ComponentInternals@1 


e runjava -jar jarjar.jar process rulefile.txt 
<input jar> <output jar> 


e Create an Android project and add all these jars to the 
build path of the project. 


e Copy XML file containing rules to sdcard in emulator. 


DTrules 


The jar files work in Android but the following steps need to be executed to 
use DTrules in Android applications: 


e Write rules as decision tables in an Excel 
sheet. Sample Excel sheets are available at 
sampleprojects/«projectname»/DecisionTables. 


e Create a file structure as follows: 


/DecisionTables/excel sheet containing decision 
tables.xls 

/edd/file containing edd.xls 

/хт1/ 

/DTRules. xml 


e Convert Excel sheet containing rules to XML by using 
code like the following: 


Excel2XML.compile("root path", "DTRules.xml", 
"name of ruleset", "path to repository"); 
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To generate the mapping file automatically, use 
something like this: 


String [] maps = ("main" }; 
Excel2XML.compile(path, "DTRules.xml", 


"<rule name»","D:/XLS2XML/repository" тарс); 


Create an Android project. 


Add the following jars to the build path: java-cup-11a. 
jar, poi-3.6-20091214. jar, dtrules. jar. 


Create a mapping file (if not generated automatically) 
to map XML file with data into the entities. 


Add the required entities to the initialization section, 
which needs to be pushed to the entity stack before the 
first decision table is executed. As an example: 


<initialization> 

<initialentity entity="constants" epush="true" /> 
<initialentity entity="job" epush="true" /> 
<initialentity entity="value" epush="true" /> 
</initialization> 


Modify the number of each entity required to be 
created. For example: 


<entities> 
«entity name-"constants" number="1" /> 
«entity name-"job" number="1" /» 
«entity name-"value" number-"1" /» 
«/entities» 


19 


CHAPTER 2 STEPS TO PORT RULES ENGINES 


e Create a file structure in sdcard as follows: 


e /sdcard/xml/mapping file.xml,edd file. 
xml ,dt_file.xml 


e /sdcard/repository/DTRules.xml 
е /sdcard/DTRules.xml 
е /sdcard/testfiles/testcase. xml 


e Copy the generated files into appropriate directory of 
sdcard. 


Zilonis 
Zilonis jar works in Android without any issue. Here are the steps to add 
Zilonis into your Android project: 

e Create an Android project. 


e Copy the .clp file containing rules into a folder, say the 
temp folder in sdcard in emulator. 


e Add zilonisO.97b.jar and antlr. jar to the project's 
build path. 


While writing rules files (.clp) for Zilonis, please ensure the following: 


e In.clp file, only one statement can be added in one 
line, unlike CLIPS. 


e No space should be between lines. 
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Termware 


Porting Termware in Android was easy. Here is the one step: 


e Remove all debug stub-related items from Java files 
belonging to ua. gradsoft.termware and ua.gradsoft. 
termware.util in the TermWare.jar. 


Roolie 


No effort was required to port Roolie onto Android—you just need to add 
the jar file to the Android project and get going. 


OpenRules 


e Download the source code for org.apache.commons. 
beanutils, recompile it, and export it to jar after 
removing the following packages, to fix multiple 
definition issues: 


org.apache. commons. logging 
оге .арасһе. commons. logging. impl 
e Теп, repackage it using the jarjar.jar utility: 


e Create rulefile.txt containing the following 
rule: rule java.beans.** com.googlecode. 
openbeans.@1 


e Run the following command in command prompt 
to repackage: java -jar jarjar-1.4.jar process 
rulefile.txt «input jar» «output jar» 
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e Download poi-3.6-20091214. jar for Excel-sheet 
processing. 


e Download openbeans-1.0. jar for using com. 
googlecode.openbeans, as OpenRules uses Java beans 
extensively, which is not supported by Android. 


• Download commons-lang-2.3.jar and remove the 
org.apache.commons.lang.enum package, then 
recompile it. 


e Create an Android project and add all these jars to the 
build path of the project. 


e  OpenRules seems to have hard coded the path of 
openrules.config dir, in which template files need to 
be stored. Create a directory openrules.config under 
sdcard and put the rule and template files there. 


JxBRE 


The following steps need to be followed to port JXBRE into Android: 
e Download the source code of Xerces 1.4.4 (XML Parser). 
e Change the name of package javax to anything else. 
e Recompile the source code and build the project. 
e Export it to jar file xerces. jar. 
• Download jxbre. jar and ideaityUtil. jar. 


e Create an Android project and add all these jars to the 
build path of the project. 
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Download the XML Schema file businessRules. xsd. 


Copy the rule file (.xml) and businessRules.xsd into 
emulator, from which it can be accessed in the project. 


JEOPS 


JEOPS can be ported into Android as follows: 


Create a new Java project. 


Add the JavaBean file (declaring the variables being 
used and their accessor methods) to it. Compile it and 
copy the .class file from bin. 


Create a new directory and paste the .class file just 
generated there in appropriate folders according to the 
package name specified in the .class file. 


Also, copy the rule-base file (.rules) to this directory. 
Download JEOPS.jar and put it in the directory. 


In command prompt, go to the location/path of this 
new directory and execute the following command to 
generate a Java file from the rule-base file: 


java -cp JEOPS.jar;. jeops.compiler.Main <rule file> 


Create an Android project and add the generated rule-base 
java file in the project. 


Create a new jar with the JavaBean . java file (by 
compiling it and exporting it to jar) and add it to the 
build path of your Android project. 
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e Add the following lines to the code of the rule-base Java 
file for accessing tell(): 


_knowledgeBase.tell(f1); 

_knowledgeBase.tell(f2); 

private jeops.AbstractKnowledgeBase _knowledgeBase; 
_knowledgeBase = knowledgeBase; 


e Also add JEOPS. jar to the build path of your project. 


Sample Code Snippet 


This code snippet will help you understand how to integrate a rules engine 
with an Android application. 


CLIPS 


Let’s build a smart application using the CLIPS rule engine to assess 
diarrhea symptoms for a patient. 
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Figure 2-1 shows what the app looks like. 


2.) SHOAGPLOO371 OE 
AN «P Q 5 Л 10:08 am 





Assessment 


Please answer all the questions. 
How many days patient is having diarrhea? 


1 


Is there blood іп stool? 


O ves | Мо 


Is patient lethargic or unconscious 


ЧӘ, Мо 


Is patient restless or irritable? 


| “= © Мо 


Is patient's eye sunken? 


@ “= © Мо 


Pinched abdomen becomes normal very slowly? 


© = | Мо 


Pinched abdomen becomes normal slowly? 


Figure 2-1. What the app looks like 
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The diarrhea guideline can be easily codified in CLIPS as diarrhoea.clp. 


35 ---- DIARRHEA MANAGEMENT -- - - - - 


;--- Printout the response code--- 
33 If the Remedy(Rx) is asserted, then printout the remedy. 


(defrule print diarrhea message2 
(Rx diarrhea signs code(code ?b)) 


(bind ?*WHODecisionCode* (create$ ?*WHODecisionCode* ?b)) 
;(printout t ?*WHODecisionCode* crlf) 


) 


;; RULES FOR ASSESSMENT OF PATIENT STATE AND TRIGGER THE 
DIARRHEA MANAGEMENT 


;--- Check if the patient has diarrhea --- 

33 If the patient data has (diarrhea yes) then (check blood in 
stool) and (classify dehydration) 

33 If the patient data has (diarrhea no) then (check other disease) 


(defrule check-diarrhea yes 
(diarrhea data (diarrhea yes)) ;; Check if the patient 
has diarrhea 
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(assert (check blood in stool)) 33 TRIGGER 
CHECK BLOOD IN STOOL 
(assert (classify dehydration))) 33 TRIGGER 


CLASSIFY DEHYDRATION 


(defrule check-diarrhea no 
(diarrhea data (diarrhea no)) 
=> 
(assert (check other disease)) ) 


;--- Rule check blood in stool --- 
;; If the patient has (blood in stool) then the patient state 
is (dysentery). 


(defrule check-blood in stool-yes 
(check blood in stool) 
;; check if the action is triggered from the diarrhea 
(diarrhea data (blood in stool yes)) 
;; check if the patient has blood in stool 


(assert (Rx diarrhea signs code (code "10")))) 
33 ASSERT THE Decision Code : 1 which means dysentry 


;--- Rule check blood in stool --- 


;; If the patient has (no blood in stool) then the patient 
state is (no dysentery). 
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(defrule check-blood in stool-no 
(check blood in stool) 
33 Check if the action is triggered from the diarrhea rule system 
(diarrhea data (blood in stool no)) 
;; Check if the patient has no blood in stool 
=>) ;; END THE ASSESSMENT ОҒ DYSENTERY 


(defrule classify-severe dehydration 

(classify dehydration) 

33 Check if the action is triggered from the diarrhea rule system 

(diarrhea data(blood in stool no)) 

(diarrhea data(severe condition count ?w&:(>= ?w 2))) 
33 If more than two of the following 
some dehydration signs are satisfied 

(diarrhea data(how many days ?x&:(<= ?x 14))) 

;; If diarrhea 14days or more 


(assert (Rx diarrhea signs code (code "5"))) 
; (assert (check-more than 14days-severe dehydration case)) 


) 


(defrule classify-severe dehydration child able to drink 
(Rx diarrhea signs code (code "5")) 
(diarrhea data (not able to drink or drinking poorly no)) 
=> 

(assert (Rx diarrhea signs code (code "5A"))) 
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(defrule classify-severe dehydration child not able to drink 
(Rx diarrhea signs code (code "5")) 
(diarrhea data (not able to drink or drinking poorly yes)) 
=> 

(assert (Rx_diarrhea_signs code (code "5B"))) 


(defrule classify-some_dehydration 

(classify dehydration) 

33 Check if the action is triggered from the diarrhea rule system 

(diarrhea data (blood in stool no)) 

(diarrhea data(some condition count ?w&:(>= ?w 2))) 

(diarrhea data (severe condition count ?y&:(< ?y 2))) 
;; If more than two of the following 
some dehydration signs are satisfied 

(diarrhea data (how many days ?x&:(<= ?х 14))) 

;; If diarrhea 14 days or more 


(assert (Rx diarrhea signs code (code "6"))) 
;(assert (check-more than 14days-some dehydration case)) 


FPIFIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIY 


(defrule classify-no dehydration 
(classify dehydration) 33 Check if the 
action is triggered from the diarrhea rule system 
(diarrhea data (blood in stool no)) 
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(diarrhea data (how many days ?х8:(<- ?x 14))) 
(diarrhea data (severe condition count ?w&:(< ?w 2))) 
(diarrhea data(some condition count ?y&:(< ?y 2))) 


(assert (Rx diarrhea signs code (code "7"))) 


FPIFIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIY 


33 RULES FOR DETERMINATION OF TREATMENT OBJECTIVES BASED ON 
PATIENT'S STATE 

;--- Rules for Assessment of Persistent Diarrhea --- 

;--- Check-more than 14days --- 


;--- Rules for Check-more than 14days - Patient is classified 
to either have Severe or Some dehyration + diarrhea is »14 

; then it is severe persistent diarrhea 

(defrule check-severe persistent diarrhea-severe deh case 
;(check-more than 14days-severe dehydration case) 

;; Check if the assessment of Persistent Diarrhea is triggered 
(or (diarrhea data (some condition count ?w&:(>= ?w 2))) 
(diarrhea data (severe condition count ?y&:(>= ?y 2)))) 
(diarrhea data (how many days ?x8:(» ?x 14))) 

(diarrhea data (blood in stool no)) 

;; If diarrhea 14days or more 

-> 

(assert (Rx diarrhea signs code(code "8"))) ) 

33 ASSERT THE TREATMENT OBJECTIVE :SEVERE PERSISTENT DIARRHEA 
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;--- Rules for Check-more than 14days - Patient has not been 
classified to have dehydration but if diarrhea is »14 days then 
it is persistent diarrhea 


(defrule check-persistent diarrhea-no deh case 
;(check-more than 144ау5-по dehydration case) 

;; Check if the assessment of Persistent Diarrhea is triggered 
(diarrhea data (some condition count ?y&:(< ?y 2))) 
(diarrhea data(severe condition count ?w&:(< ?w 2))) 
(diarrhea data(how many days ?x8:(» ?x 14))) 

(diarrhea data (blood in stool no)) 

;; If diarrhea 14days or more 

=> 

(assert (Rx diarrhea signs code (code "9"))) ) 

33 ASSERT THE TREATMENT OBJECTIVE :PERSISTENT DIARRHEA 


The user input can be modeled as diarrheaData: 


public class diarrheaData implements Parcelable ( 
int iNumberofDays-0; 
String sBlood In Stool-"no"; 
String sLethargic Unconscious-"no"; 
String sRestless Irritable-"no"; 
String sSunken Eyes-"no"; 
String sSkin Pinch Veryslow-"no"; 
String sSkin Pinch Slow-"no"; 
String sNot Able To Drink or Drinking Poorly-"no"; 
String sDrinking Eagerly or Thirsty-"no"; 
String sOther Severe Disease-"no"; 
String sTrained nurse for iv immediately-"no"; 
String sIv available in 30min-"no"; 
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String sTrained nurse for ng tube immediately-"no"; 


static { 
try { 
System. loadLibrary("CLIPSJNI"); 
if(clips == null) { 
clips = new Environment(); 
} 
) 


catch(UnsatisfiedLinkError Ше) { 
Log.e("JNI", "Could not load 
libCLIPSJNI.so!"); 
) 
private static Environment clips = null; 
static ( 
try { 
if(clips == null) { 
clips = new Environment(); 
) 
clips.clear(); 
clips.load("diarrhoea.clp"); 
String myassertString - "(diarrhea data 
(diarrhea yes) " + 
"(blood in stool "+mydiarrheaData.sBlood Іп 
Stool +") "+ 
"(how_many_days "+mydiarrheaData. 
iNumberofDays+") " + 
"(lethargic unconscious "+mydiarrheaData. 
sLethargic Unconscious+") "+ 
"(restless irritable "«mydiarrheaData.sRestless 
Irritable+") " + 
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"(sunken eyes "+ mydiarrheaData.sSunken_Eyes+") " + 
"(skin pinch veryslow "+mydiarrheaData.sSkin_ 
Pinch Veryslow+") " + 

"(skin pinch slow "«mydiarrheaData.sSkin Pinch 
Slow") " + 

"(not able to drink or drinking poorly "«mydiarrhea 
Data.sNot Able To Drink or Drinking Poorly+") " + 
"(drinking eagerly or thirsty "+mydiarrheaData. 
sDrinking Eagerly or Thirsty+") " + 

"(other severe Wdisease " + otherSevereDisease + "))'; 


clips.assertString(myassertString); 
clips.run(); 
MultifieldValue mv = (MultifieldValue) 
clips.eval("?*WHODecisionCode*"); 





String WHODecision; 
List theList = mv.listValue(); 
for(Iterator itr = theList.iterator(); itr.hasNext();) 
{ 
StringValue myValue = (StringValue) itr.next(); 
WHODecision = WHODecision + myValue.toString() + " "; 


The decision will be available in WHODecision variable. 
Ifthe reader could understand the preceding CLIPS example, the rest 
of the examples will be straightforward to understand. 
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JRuleEngine 


Class.forName( "org.jruleengine.RuleServiceProviderImpl" ); 
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String path - Environment.getExternalStorage 
Directory().getAbsolutePath()-*"/temp/example3.xml"; 
InputStream inStream - new FileInputStream( new 
File(path) ); 

// Get the rule service provider from the provider 
manager. 

RuleServiceProvider serviceProvider - 








RuleServiceProviderManager.getRuleServiceProvider 
( "org.jruleengine" ); 

// get the RuleAdministrator 

RuleAdministrator ruleAdministrator - 





serviceProvider.getRuleAdministrator(); 
System.out.print1n("\nAdministration API\n"); 
System.out.println( "Acquired RuleAdministrator: " 
* ruleAdministrator ); 

// get an input stream to a test XML ruleset 

// This rule execution set is part of the TCK. 
// InputStream inStream - new FileInputStream( 
"example3.xml" ); 

System.out.println("Acquired InputStream to 
example3.xml: " + inStream ); 

// parse the ruleset from the XML document 
RuleExecutionSet resi - ruleAdministrator. 





getLocalRuleExecutionSetProvider( 

null ).createRuleExecutionSet( inStream, null ); 
inStream.close(); 

System.out.println( "Loaded RuleExecutionSet: " + res1); 


CHAPTER 2 STEPS ТО PORT RULES ENGINES 


// register the RuleExecutionSet 

String uri = res1.getName(); 

ruleAdministrator.registerRuleExecutionSet 

(uri, res1, null ); 

System.out.println( "Bound RuleExecutionSet to 

URI: " + uri); 

// Get a RuleRuntime and invoke the rule engine. 

System.out.println( "\nRuntime API\n" ); 

RuleRuntime ruleRuntime - serviceProvider. 

getRuleRuntime(); 

System.out.println( "Acquired RuleRuntime: " + 

ruleRuntime ); 

// create a StatefulRuleSession 

StatefulRuleSession statefulRuleSession - 
(StatefulRuleSession) ruleRuntime. 








createRuleSession( uri, 
new HashMap(), 
RuleRuntime.STATEFUL SESSION TYPE ); 
System.out.println( "Got Stateful Rule Session: " + 
statefulRuleSession ); 
// Add some clauses... 
ArrayList input = new ArrayList(); 
input.add(new Clause("Socrate is human")); 
// add an Object to the statefulRuleSession 
statefulRuleSession.addObjects( input ); 
System.out.println( "Called addObject on Stateful 


Rule Session: " + statefulRuleSession ); 


statefulRuleSession.executeRules(); 
System.out.println( "Called executeRules" ); 
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// extract the Objects from the statefulRuleSession 
List results - statefulRuleSession.getObjects(); 


System.out.println( "Result of calling getObjects: " + 


results.size() + " results." ); 
// Loop over the results. 
Iterator itr - results.iterator(); 
while(itr.hasNext()) { 
Object obj = itr.next(); 
System.out.println("Clause Found: "+obj. 
toString()); 
} 
// xelease the statefulRuleSession 
statefulRuleSession.release(); 
System.out.println( "Released Stateful Rule Session." ); 


DTrules 


String path - Environment.getExternalStorageDirectory(). 
getAbsolutePath()+"/"; 

String decisionTable = "Compute Eligibility"; 

//String decisionTable = "Calculate Individual Income"; 
RulesDirectory rd = new RulesDirectory( 

path, 

"DTRules. xml"); 

RuleSet rs = rd.getRuleSet("KidAid") ; 

IRSession session; 

try { 

Excel2XML.compile(path, "DTRules.xml","KidAid", "sdcard"); 
session - rs.newSession(); 

Mapping mapping - session.getMapping(); 
mapping.loadData(session, path+"testfiles/"+"TestCase 001.xml"); 
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session.execute(decisionTable); 
printReport(session, System.out); 
) catch (RulesException e) ( 

// TODO Auto-generated catch block 
e.printStackTrace(); 





) catch (Exception e) ( 
// TODO Auto-generated catch block 
e.printStackTrace(); 


} 
} 


Zilonis 


String fileName - "YOUR RULE FILE"; 
FileInputStream fstream - new FileInputStream(fileName); 








int lineCount = getLines(fileName) ; 
System.out.println("line is "+ lineCount) ; 
DataInputStream dis = new DataInputStream(fstream) ; 














BufferedReader br = new BufferedReader (пем 
InputStreamReader(dis)); 





ZilonisLexer lexer = new ZilonisLexer(dis); 
ZilonisParser parser - new ZilonisParser(lexer); 
GenericEventHandler geh - new GenericEventHandler(rete); 








parser.setEventHandler(geh); 

try { 

while(lineCount-- > 0) ( 
parser.statement(); 

} 

} catch (RecognitionException е) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
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} catch (TokenStreamException е) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 

) 

) catch (FileNotFoundException ез) { 
// TODO Auto-generated catch block 
e3.printStackTrace(); 

} catch (IOException e) { 

// TODO Auto-generated catch block 
e3.printStackTrace(); 


) 











Termware 


String[] args = {"iReduce"}; 
TermWare.getInstance().init(args); 

ITermRewritingStrategy strategy-new FirstTopStrategy(); 
IFacts facts-new DefaultFacts(); 

TermSystem termSystem-new TermSystem(strategy,facts,TermWare. 
getInstance()); 

termSystem.addRule("x-»y"); 








termSystem.addRule("y-»z"); 

Term inputTerm-TermWare.getInstance().getTermFactory(). 
createAtom("x"); 

Term outputTerm-termSystem.reduce(inputTerm); 
if(outputTerm.getName() .equals("z"))( 


Log.d("iReduce Termware","success"); 


) 
}}eatch(TermWareException ex){ 


Log.e("iReduce Termware", "eror:"+ex.getMessage()); 





ex. printStackTrace(); 


H 
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Roolie 


public class AbdominalRuleArgs extends RuleArgs{ 





public enum ArgField 

{ 

User 

› right lower abdomen 
› left lower abdomen 

, pain nausea 

» blood in stool 





» blood in urine 
B 
public String getUser() 

{ 

return getString(ArgField.User); 

} 

public void setUser(String user) 

{ 

setString(ArgField.User, user); 

} 

} 

public abstract class AbdominalRule implements Rule{ 
QOverride 

public boolean passes(RuleArgs ruleArgs) { 

// TODO Auto-generated method stub 

if (false -- (ruleArgs instanceof AbdominalRuleArgs)) 
( 

Log.msg("ruleArgs must be ап instance of 
AbdominalRuleArgs "); 

return false; 


) 
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// Cast RuleArgs to AbdominalRuleArgs and validate 
AbdominalRuleArgs abArgs - (AbdominalRuleArgs) ruleArgs; 
// Muse have all args set 

if (false -- abArgs.isright lower abdomenSet() 

|| false -- abArgs.isleft lower abdomenSet() 








|| false -- abArgs.isUserSet() 





|| false -- abArgs.ispain nauseaSet() 

|| false -- abArgs.isblood in stoolSet() 
|| false == abArgs.isblood in urineSet() 
) 


{ 
Log.msg("Not all the arguments іп AbdominalRuleArgs are set."); 








return false; 
) 
// lf all args are there, let the child class do its 
evaluation 
return passes(abArgs); 
} 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
// Get the config file as an InputStream 
InputStream is - 
Main.class.getClassLoader(). 
getResourceAsStream( 
"roolie/abdominal/roolie-config.xml"); 
RulesEngine rules - new RulesEngine(is); 
// Cxeate some rule arguments (aka "Facts") to test 
for some users 
List«AbdominalRuleArgs» abdominalRuleArgsList = 
createRuleArgsToTest(); 
// See if rules pass for each BankingRuleArgs created. 





for (AbdominalRuleArgs ruleArgs : abdominalRuleArgsList) 
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msg("\n* Evaluating " + ruleArgs.getUser()+"'s 
health:\n"); 

boolean isUltrasound =rules.passesRule("Ultrasound", 
ruleArgs) ; 

boolean isCTScan =rules.passesRule("CTScan", ruleArgs); 
boolean isStoolTest1 -rules. 
passesRule("StoolTest1", ruleArgs); 

boolean isStoolTest2 -rules. 
passesRule("StoolTest2", ruleArgs); 

boolean isStoolTest3 -rules. 
passesRule("StoolTest3", ruleArgs); 

boolean isNothing -rules.passesRule("NoTest", 
ruleArgs); 


UserInput userInput-new UserInput("no","yes", "yes", "no" , "уеѕ"); 


Response response-new Response(); 

String fileName - "file:sdcard/openrules. 
config/DecisionOneOrTwo.xls"; 

Decision decision - new Decision("DecisionAbdom 
inalPain",fileName); 

decision.put("userInput", userInput); 
decision.put("response", response); 
decision.execute(); 


public class UserInput ( 
String right lower abdomen; 


String left lower abdomen; 


String pain nausea; 
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String blood in stool; 

String blood in urine; 

public UserInput(String rla,String lla,String pn,String 

bis,String biu){ 
this.right lower abdomen -rla; 
this.left lower abdomen =11а; 
this.pain nausea -pn; 
this.blood in stool -bis; 
this.blood in urine -biu; 

) 

public String getRight lower abdomen() { 
return right lower abdomen; 


) 
public void setRight lower abdomen(String right lower | 
abdomen) ( 

this.right lower abdomen - right lower abdomen; 
) 


public class Response ( 

String comment; 

public Response(){ 
this.comment-"Helllllp"; 

} 

public String getComment() { 
return comment; 

} 

public void setComment(String s) ( 
comment - s; 
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String[] products; 
/** 
ж @return 
*/ 
public String[] getProducts() { 
if (products -- null) 
products = new String[0]; 
return products; 


) 
/** 
ж @param strings 
*/ 
public void setProducts(String[] strings) { 
products - strings; 
) 
public String toString() 5 
StringBuffer buf - new StringBuffer(2500); 
buf.append("Offered Products:").append("\n"); 
for (int i = 0; i < getProducts().length; ++i) 5 
buf.append(" Nt") .append(getProducts() 
[1]).аррепа("\п"); 
} 
if (comment != null) 
buf.append("Comment: ").append 
(comment) .append(" An"); 


return buf.toString(); 
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JxBRE 


public void onCreate(Bundle savedInstanceState) { 
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super .onCreate(savedInstanceState); 
bre = пен BREImpl(); 
args-new String[]( "/data/data/" +packageName +"/files/ 
abdominal.xml"); 
//args="-s D:\\android_training\\rules\\discount. xml"; 
setContentView(R. layout .main) ; 
copyCLPFiles("abdominal. xml") ; 
copyCLPFiles("businessRules.xsd") ; 
AbdominalMainLoad(args) ; 
Inputs order = new Inputs(); 
getTotal (order) ; 
) 
private void copyCLPFiles(String fileName) 5 
try ( 
File file - getFileStreamPath(fileName); 
if(file.exists()) { 
return; 
) 
else ( 
InputStream myInput = 
getAssets().open(fileName); 
OutputStream myOutput - new 
FileOutputStream( 
"/data/data/" + 
getPackageName() +"/ 
files/"+fileName) ; 
//transfer bytes from the 


inputfile to the outputfile 
byte[] buffer = new byte[1024]; 
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int length; 
while ((length - myInput. 
read(buffer) )>0){ 
myOutput .write(buffer, 
0, length); 
) 
//Close the streams 
myOutput. flush(); 
myOutput.close(); 
myInput.close(); 


) 
catch (FileNotFoundException е) { 


e.printStackTrace(); 
} catch (IOException e) { 
e.printStackTrace(); 


} 
} 
public void AbdominalMainLoad(String[] args) { 
try { 
Document doc - loadFile(args[0]); 
// Let's register as а listener.... 
((BREImpl)bre).addlistener(this); 
((BREImpl)bre).init(doc); 
} 
catch (Exception e) { 
System.err.println("Could not create 
document"); 
e.printStackTrace(); 
} 
} 
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/** 
* Let's pretend that we have an Object called Order and 
it has all 
* relevant order information including an Object for 
the Product that 
* is ordered 
*/ 
public void getTotal(Inputs aOrder) { 
// Have to do this so the anonymous classes can 
get to it.. 
inp = aOrder; 
BRERuleContext aBRC = bre.getRuleContext(); 
/** 
* This is the best way to do this. Better than 
wrapper classes. 
* Don't know why I didn't think of this earlier.... 
*/ 
aBRC.setFactory(BLOOD IN URINE, new 
BRERuleFactory() { 
public Object executeRule(BRERuleContext 
aBrc, Map aMap, Object aStep) { 








return inp.getBlood in urine(); 


}); 
aBRC.setFactory(BLOOD IN STOOL, new 


BRERuleFactory() { 
public Object executeRule 





(BRERuleContext aBrc, Map aMap, Object 
aStep) { 
return inp.getBlood in stool(); 





Ы; 
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aBRC.setFactory(RIGHT LOWER ABDOMEN, new 
BRERuleFactory() { 
public Object 





executeRule(BRERuleContext aBrc, Map 
aMap, Object aStep) { 
return inp.getRight lower 





abdomen() ; 


}); 
aBRC.setFactory(LEFT LOWER ABDOMEN, new 


BRERuleFactory() { 
public Object executeRule(BRERuleContext 
aBrc, Map aMap, Object aStep) { 








return inp.getLeft lower abdomen(); 


H; 
aBRC.setFactory(PAIN NAUSEA, new BRERuleFactory() { 


public Object executeRule(BRERuleContext 
aBrc, Map aMap, Object aStep) { 





return inp.getPain nausea(); 


}); 
aBRC.setFactory(RECCTEST BLOODURINE, new 


BRERuleFactory() { 
public Object executeRule(BRERuleContext 
aBrc, Map aMap, Object aStep) { 








return DecisionString.getDecis 
ionString( new String((String) 
aMap.get(TEST1)) ); 


13 
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aBRC.setFactory(RECCTEST RIGHTLOWER, new 
BRERuleFactory() { 
public Object executeRule(BRERuleContext 
aBrc, Map aMap, Object aStep) { 
return DecisionString.getDecision 
String( пен String( (String) 
aMap.get(TEST2)) ); 








}); 
aBRC.setFactory(RECCTEST_LEFTLOWER, new 


BRERuleFactory() { 
public Object executeRule(BRERuleContext 
aBrc, Map aMap, Object aStep) { 
return DecisionString.getDecis 








ionString( new String((String) 
aMap.get(TEST3)) ); 


)5 
aBRC.setFactory(NOTHING, new BRERuleFactory() { 
public Object executeRule(BRERuleContext 
aBrc, Map aMap, Object aStep) { 
return DecisionString.get 





DecisionString( new String 
((String)aMap.get(TEST4)) ); 


}); 

/ /bxe.process(); 
bre.process("SET1"); 
bre.process("SET2"); 
bre.process("SET3"); 
bre.process("SET4"); 
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/ /System.out.println(bre.getRuleContext(). 
toString()); 
if ((aBRC.getResult (RECCTEST_ 
BLOODURINE))!-null) { 
System.out.println((String)aBRC. 
getResult(RECCTEST BLOODURINE) .getResult()); 
} 
е1ве {} 
if ((aBRC.getResult (RECCTEST_ 
RIGHTLOWER))!-null) { 
System.out.print1n( (String) aBRC.getResult(RECCTEST_ 
RIGHTLOWER) .getResult()); 
} 
else {} 
if ((aBRC.getResult (RECCTEST LEFTLOWER) )!=null) 
System.out.println(aBRC.getResult 
(RECCTEST_LEFTLOWER) .getResult()); 
} 
else () 
if (aBRC.getResult(NOTHING)!-null) { 
System.out.println(aBRC.getResult 
(NOTHING) .getResult()); 


} 
else 1) 
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JEOPS 


for(int i-0; i «100; i++) ( 
Fibonacci f - new Fibonacci(i); 
FibonacciBase kb - new FibonacciBase(new 
PriorityConflictSet()); 
kb.tell(f); 
kb.run(); 
System.out.println(f.getN() + "the number of the fibonacci 





series = " + f.getValue()); 


) 
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CHAPTER 3 


Issues Faced While 
Porting Rules Engines 


We found a few issues while trying to write rules in each ofthe following 


rules engines. The reader should make a note of these issues. 


Jruleengine: It does not support OR operator. 


Zilonis: It doesn't support OR, defglobal, or bind 
keywords, unlike CLIPS. 


DTRules: The facts have to be provided іп an XML file, 
so running rules in an environment where facts have to 
be provided at runtime is complex and tedious. 


Termware: Rules have to be written in code itself. 


Roolie: Too many rules files need to be developed, and 
each rule needs to be coded in a separate Java file. 


JxBRE: ElseIf doesn't work in XML files (we can use 
Set instead). Only one If works in the logic part of 
the rules file (.xml). Any one of (Rule, Log, Logic, 
While, InvokeSet, ForEach, Retract} is expected 
before an If element. 
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е  JEOPS: The variables used as arguments for calling a 
function need to be initialized in rules file itself (by 
calling appropriate setter method). 


е OpenRules: There is no document/readme explaining 
how to write rules. 


Porting Issues for Other Rules Engines 


The reader might face the following issues when porting other rules engines: 


e Drools: Eclipse runs out of memory (500 MB) while 
converting it to dalvik format. Increasing the memory 
of Eclipse did not solve the issue. The reader may try to 
use high-end machine (RAM » 4 GB). 


e JLisa: While running in Android, it throws a stack 
overflow issue. Reader may contact JLisa support for a 
resolution. 


e Take: Need Java compiler at runtime. Reader may 
contact Take support for Android compiler support. 


e Jess: Development license costs around $15,000 (US). 
e OpenRules: 


e Method org.apache.poi.hssf.usermodel. 
HSSFSheet.autoSizeColumn in poi-3.6-20091214. 
Дат uses class java.awt.font.FontRenderContext, 
which is not available in Android. 


e Method com.googlecode.openbeans. 
StandardBeanInfo. getIcon uses class java.awt. 
image, which is not available in Android. 
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While processing decisions, garbage collection runs 
multiple times, indicating huge memory usage. 


Did not receive any response from the company 
OpenRules about the type of commercial license 
supported and the cost of the license. 
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СНАРТЕК 4 


Comparison of Rules 
Engines for Mobile 
Platforms 


This chapter contains a comparison of rules engines used for developing 
on mobile platforms. 


Summarizing the Rules Engines 


Out ofall nine rules engines evaluated for Android, CLIPS is undoubtedly the 
most elegant, as it is fastest, free, and supports its own rules programming 
language. It is followed by OpenRules, where rules can be easily written in 

an Excel sheet, then by JEOPS, since algorithms can be easily represented. 
Next would be Termware, since integrating rules with your application is 
straightforward. Because of its portability, extensibility, and low cost, CLIPS 
has been widely used by governments, private enterprises, and universities. 
CLIPS has enabled the embedding of artificial intelligence into a wide range of 
applications in diverse computing environments. 


Comparison of Rules Engines 


Table 4-1 shows a comparison of the rules engines. 
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СНАРТЕК 5 


Requirements апа 
Challenges Faced in 
Knowledge Application 
Development 


Knowledge management is defined as creating, sharing, using, and 
managing information for a system or organization. 

In this chapter, we will discuss the requirements, challenges, 
design, and implementation of two knowledge management systems: 
SmartAppGen and AutoQuiz. 


Introducing SmartAppGen and AutoQuiz 


SmartAppGen automatically generates the corresponding knowledge 
application from structured knowledge represented as XML, Excel 
sheets, PPT, and so forth. For example, suppose a health worker needs 
to undergo training for a few weeks. At the training, they have to go 
through hundreds of pages of knowledge materials. What if a knowledge 
application is automatically built using the knowledge available and 
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then installed on their smartphone? The training time could be reduced 
drastically; also, the health worker would not have to remember hundreds 
of pages of documentation. They would not have to refer to the printed 
guidelines from time to time to execute their daily routine. So, it is clear 
that knowledge application can increase the efficiency and accuracy of 
healthcare services. 

Not all knowledge is so well formatted that a knowledge application 
can be automatically developed and installed on a smartphone. So, 
people would still have to undergo training and remember the things 
learned at training. AutoQuiz comes in handy in cases where knowledge 
(for instance, training materials, presentations, and so on) is given in 
a text format. It can generate a meaningful quiz from the unstructured 
knowledge. At the end of any training or presentation, a quiz can be 
automatically generated, and all participants can be asked to take the quiz. 
Then, their scores are immediately calculated. This achieves three things: 
people would be more alert in training, the trainer would get immediate 
feedback on the effectiveness of their training, and the trainer/manager 
would know which people were falling short in understanding and take 
appropriate measures to bring them up to the mark. This chapter will help 
with automating the knowledge management of your company or institute. 


Developing Knowledge Applications 


To design, develop, and deploy a knowledge application, the steps shown 
in Figure 5-1 are executed. 


Digitize Codify Develop Deploy 


application 


Design UI в 


Knowledge Knowledge application 





Figure 5-1. Knowledge application development 
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Here are the main requirements and challenges associated with a 


knowledge application: 


Representing knowledge in a digitized format and 
converting it into rules is a cumbersome and time- 
consuming process. 


The user interface can vary based on user profile. For 
example, a user interface can be text based for tech 
savvy, icon based for semi-literate, or voice based for 
illiterate users. 


Data persistence and maintenance is cumbersome 
and if not managed properly may result in application 
outage. 


The same application may need to be developed for 
multiple mobile phone platforms; e.g., Android, iOS, 
and so forth. 


Common features get implemented again and again 
in such mobile applications, wasting thousands of 
development hours. 


Multiple languages may need to be supported. 


Application installable may need to be customized 
based on user profile. 


Upgrading knowledge application should be feasible 
over the air. 


Let us see in the next chapter how SmartAppGen can automatically 


generate a knowledge application. We will also address the challenges 


faced by knowledge application developers. 
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PART Il 


SmartAppGen: 
Automatically 
Generate Knowledge 
Application from 
Structured Knowledge 


СНАРТЕК 6 


Design and 
Implementation 
of SmartAppGen 


SmartAppGen is a set of frameworks to help generate knowledge-based 
applications from structured knowledge automatically. Structured 
knowledge can be provided in various formats, like an Excel sheet, text, 
and XML. 


e Questions, rules, information, and so forth are 
extracted from the document and saved as XML. 


e From the generated XML(s), the corresponding 
Android layout, Android activity, CLIPS rules, and 
decision engine are generated. 


e Various frameworks, like speech-to-text, audio 
capturer, photo capturer, upload manager, and so forth 
are also automatically embedded into the project. 


e Generated code frameworks are glued together to 
generate a full-fledged Android project from a new 
Android project. 
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СНАРТЕК 7 


Architecture 
of SmartAppGen 


We came up with a three-tier high-level and low-level architecture for 


SmartAppGen. See Figure 7-1. 


Voice Processor Image Processor Social Networking 


Knowledge Extractor Knowledge Processor Application Generator 
Application Updater Application Installer Арріісайоп Соппесїог 


(ИНЕСІ "ЕВ | 


Figure 7-1. High-level SmartAppGen architecture 








A complex knowledge application needs to support social networking, 
image and voice processing, over-the-air upgrade capabilities, and 
persistence-management functionalities. So, SmartAppGen must be able 
to generate such functionalities. 
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Based on the application workflow, we came up with a low-level 
architecture for SmartAppGen. 

Figure 7-2 describes all components of SmartAppGen present in the 
presentation, application, and data tiers. 


Voice to Text Converter Photo Capturer Audio Capturer 


Chat Framework 


Edge Intelligence 
Framework 





Figure 7-2. Low-level architecture 


Let us describe each of the components in detail. 


Model Code Generator 


This framework generates the code representing the model for the 
knowledge/guideline (e.g., GuidelineData.java). 


View Code Generator 


This framework generates the user interface code (e.g., Guidelinescreen. 
java) for the knowledge/guideline. 
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Controller Code Generator 


This framework generates the controller code for the knowledge guideline 
(e.g., Mainactivity.java). 


Question Extractor 


This block extracts the guideline type (decisive/informative), questions, 
answer types, and answer values and builds question.xml automatically. 


Context Manager Generator 


This framework generates a context manager corresponding to the 
knowledge application. 


Rules Generator 


This framework converts the digitized guidelines to rules. For each 
guideline, a set of rules files are generated. In the DTRules rules engine, 
decisions are represented in an Excel sheet. Excel2XML converts decisions 
to XML files that are processed by the rules engine. In CLIPS, a rules 
header can easily be generated from the registration information and 
questions. The developer would have to just codify the remaining part of 
the rules. 


Language Translator 


This framework provides support for translating the application text into 
multiple languages. 
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Persistence Helper 


This framework will help with persisting the application data to a local 
database. 


Interaction to XML Converter 


This framework converts the user interactions (e.g., model) to XML. 


Rules Upgrader 


This framework will help upgrade rules over the air. 


Cwac-updater 


This open source framework [1] can be used to upgrade Android 
applications over the air. 


Voice-to-Text Converter 


This framework will convert a user's voice to text. 


Text-to-Voice Converter 


This framework will help convert text to voice and help the application 
interact with users via voice. 
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Photo Capturer 


This is a generic framework to capture photos. 


Audio Capturer 


This is a generic framework for capturing audio for voice recording or any 
other purpose. 


Chat Framework 


This framework enables the chat functionality. 


Edge Intelligence Framework 


This framework needs to be built on top of the rules engine and helps the 
application communicate with the rules engine with ease. 


REST Client 


This framework will help the application make use of restful web services 
exposed by any JAX-RS-compliant server. 


Installation Manager 


This framework ensures that the appropriate components and accessories 
are packaged in the installable based on the profile of the user. 
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СНАРТЕК 8 


Example of Generating 
Knowledge Application 
from Knowledge 


Figure 8-1 represents knowledge from which one can derive a list of 
medical tests a patient needs to undergo based on the symptoms of the 
patient. 
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Chief Complaint - Chest Pain | 
‘Blood 
|Tests/ 
Blood 
(Oxygen 

Symtoms __ oo EKG Level _ (No Tes chest x-ray 





Does the pain occur with exertion? yes 


Does the pain radiate to 
the neck, 
jaw, and/or arms? yes 


Does the pain have a 
“squeezing” or 
"tightness" quality? yes 


Can the pain be 
reproduced by 
movement of the arms or 
torso or by 

pushing on a certain area 
of the chest? No yes 


Is the pain made worse by 
deep 
breathing? No yes 


Is the pain brought on by 
eating or 

lying down? Is it relieved 
with antacids? No yes 


Is it accompanied by 
shortness of 

breath, sweating, a 
feeling of "clamminess," 
nausea or indigestion? yes | 


If the pain is anginal in 

nature, does 

it last more than 15 to 30 

minutes? | |үе5 








Figure 8-1. Knowledge in Excel sheet 


From the Excel sheet depicted in Figure 8-1, corresponding Android 
layout and CLIPS rules files are generated. 
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Android Layout Corresponding 
to Knowledge 


The Android layout XML is provided here for the sake of completeness. 


«?xml version-"1.0" encoding-"utf-8"?» 
«ScrollView xmlns:android-"http://schemas.android.com/apk/res/ 
android" 
android:layout width-"match parent" 
android:layout height-"fill parent"» 
«Linearlayout xmlns:android-"http://schemas.android.com/apk/ 
res/android" 
android:id-"9*id/com test DummyProject chief complaint _ 
chest painscreen layouti" 
android:orientation- "vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"» 
<TextView android:text="Does the pain occur with exertion?" 
android:id-"9*id/com test DummyProject chief complaint chest. 
painscreen exertion" android:layout width-"wrap content" 
android:layout height-"wrap content"» 
«/TextView» 
<RadioGroup android:layout width-"wrap content" android:orien 
tation-"horizontal" android: id="@+id/com_test_DummyProject_ 
chief_complaint_chest_painscreen__exertionRadioGroup1" 
android: layout_height="wrap_content"> 
«RadioButton android:text="yes" android: layout_height="wrap_ 
content" android:checked-"false" android: id="@+id/com_test_ 
DummyProject_chief_complaint_chest_painscreen__exertion_yes" 
android: layout_width="wrap_content"> 
</RadioButton> 
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<RadioButton android:text-"no"  android:layout height-"wrap 
content" android:checked-"true" android:id-"Q«id/com test 
DummyProject chief complaint chest painscreen exertion по" 
android: layout_width="wrap_content"> 

</RadioButton> 

</RadioGroup> 

<TextView android:text="Does the pain radiate to the neck, 
jaw, and/or arms?" android:id="@+id/com_test_DummyProject_ 
chief complaint chest painscreen radiate neck jaw arms" 
android:layout width-"wrap content" android:layout 
height-"wrap content"» 

«/TextView» 

<RadioGroup android:layout width-"wrap content" android:orienta 
tion-"horizontal" android:id-"9*id/com test DummyProject chief 
complaint chest painscreen radiate neck jaw  armsRadioGroup2" 
android:layout height-"wrap content"» 

«RadioButton android:text-"yes"  android:layout height-"wrap 
content" android:checked-"false" android:id-"Qid/com test. 
DummyProject chief complaint chest painscreen radiate neck - 
jaw arms yes" android:layout width-"wrap content"» 
«/RadioButton» 

<RadioButton android:text-"no"  android:layout height-"wrap 
content" android:checked-"true" android:id-"Q«id/com test 
DummyProject chief complaint chest painscreen radiate neck - 
jaw arms no" android:layout width-"wrap content"» 
«/RadioButton» 

«/RadioGroup» 

<TextView android:text="Does the pain have a squeezing or 
tightness quality?" android:id-"Q«id/com test DummyProject 
chief complaint chest painscreen squeezing tightness" 
android:layout width-"wrap content" android: layout_ 
height-"wrap content"» 
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«/TextView» 

<RadioGroup android:layout width-"wrap content" android:orienta 
tion-"horizontal" android:id-"9*id/com test DummyProject chief 
complaint chest painscreen squeezing tightnessRadioGroup3" 
android:layout height-"wrap content"» 

«RadioButton android:text-"yes" android:layout height-"wrap 
content" android:checked-"false" android:id="@+id/com_test_ 
DummyProject chief complaint chest painscreen squeezing 
tightness yes" android:layout width-"wrap content"» 
«/RadioButton» 

«RadioButton android:text-"no"  android:layout height-"wrap 
content" android:checked-"true" android:id-"Q«id/com test 
DummyProject chief complaint chest painscreen squeezing 
tightness no" android:layout width-"wrap content"» 
</RadioButton> 

</RadioGroup> 

<TextView android:text="Can the pain be reproduced by movement 
of the arms or torso or by pushing on a certain area of the 
chest?" android:id-"Q«id/com test DummyProject chief complaint 
chest painscreen reproduced movement arms torso pushing area 
chest" android:layout width-"wrap content" android:layout 
height-"wrap content"» 

«/TextView» 

«RadioGroup android:layout width-"wrap content" android:orienta 
tion-"horizontal" android:id-"?*id/com test DummyProject chief 
complaint chest painscreen reproduced movement arms torso pushing 
area chestRadioGroup4" android:layout height-"wrap content"» 
«RadioButton android:text-"yes" android:layout height-"wrap 
content" android:checked-"false" android:id-"9id/ 

com test DummyProject chief complaint chest painscreen 
reproduced movement arms torso pushing area chest yes" 
android:layout width-"wrap content"» 


«/RadioButton» 
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<RadioButton android:text-"no"  android:layout height-"wrap 
content" android:checked-"true" android: id="@+id/ 

com test DummyProject chief complaint chest painscreen 
reproduced movement arms torso pushing area chest no" 
android: layout_width="wrap_content"> 

</RadioButton> 

</RadioGroup> 

<TextView android:text="Is the pain made worse by deep breathing?" 
android: id="@+id/com_test_DummyProject_chief_complaint_chest_ 
painscreen worse deep breathing" android: layout_width="wrap_ 
content" android: layout_height="wrap_content"> 

</TextView> 

<RadioGroup android:layout width-"wrap content" android:orienta 
tion-"horizontal" апӣгоіа:іа= "@+ій/сот test DummyProject chief 
complaint chest painscreen worse deep breathingRadioGroup5" 
android:layout height-"wrap content"» 

«RadioButton android:text="yes"  android:layout height-"wrap 
content" android:checked-"false" android:id="@+id/com_test_ 
DummyProject chief complaint chest painscreen worse deep 
breathing yes" android:layout width-"wrap content"» 
</RadioButton> 

<RadioButton android:text="no" android: layout_height="wrap_ 
content" android:checked-"true" android: id="@+id/com_test_ 
DummyProject_chief_complaint_chest_painscreen_worse_deep_ 
breathing_no" android: layout_width="wrap_content"> 
</RadioButton> 

</RadioGroup> 

<TextView android:text="Is the pain brought on by eating or 
lying down? Is it relieved with antacids?" android: id="@+id/ 
com_test_DummyProject_chief_complaint_chest_painscreen_ 
brought eating lying down relieved antacids" android: layout_ 
width-"wrap content" android:layout height-"wrap content"» 
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«/TextView» 

«RadioGroup android:layout width-"wrap content" android:orienta 
tion-"horizontal" апӣгоіа:іа= "@+ій/сот test DummyProject chief 
complaint chest painscreen brought eating lying down relieved 
antacidsRadioGroup6" android:layout height-"wrap content"» 
«RadioButton android:text-"yes" android:layout height-"wrap 
content" android:checked-"false" android:id-"9id/ 

com test DummyProject chief complaint chest painscreen 

brought eating lying down relieved antacids yes" 
android:layout width-"wrap content"» 

</RadioButton> 

«RadioButton android:text="no" android: layout_height="wrap_ 
content" android: checked="true" android: id="@+id/ 
com_test_DummyProject_chief_complaint_chest_painscreen_ 

brought eating lying down relieved antacids no" 

android:layout width-"wrap content"» 

«/RadioButton» 

«/RadioGroup» 


<LinearLayout xmlns:android-"http://schemas.android.com/apk/ 
res/android" 

android:orientation- "horizontal" 

android:layout weight-"1" 

android:layout width-"fill parent" 

android:layout height-"wrap content"» 
«Button android:text-"saveButton" android:layout weight-"0.5" 
android:id-"9*id/com test DummyProject chief complaint chest. 
painscreen saveButton" android:layout width-"wrap content" 
android:layout height-"wrap content"»«/Button» 
«Button android:text-"cancelButton" android:layout weight-"0.5" 
android:id-"9*id/com test DummyProject chief complaint chest. 
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painscreen cancelButton" android:layout width-"wrap content" 
android:layout height-"wrap content"»«/Button» 


----5піррей---------------------------------------------------- 
</LinearLayout> 

</LinearLayout> 

</ScrollView> 


Figure 8-2 depicts the Android screen corresponding to the preceding 
layout code. 


yes о 


he pain have 





Figure 8-2. Generated Android screen 
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An XMI file is automatically generated using, with results as follows: 


<ЕЗІӨ8 rule-namez"chestpain"» 
<conditions name="EXG"> 
<or> 
<condition name="Is severe palmar pallor present?" valuezs"yes"» 
</condition> 
<condition name="Does the pain radiate to the neck, jaw, and/or arms?" value="yes"> 
</condition> 
<condition name="Does the pain have a squeezing or tightness quality?" value="yes"> 
</condition> 
</or> 
«decision name="decisionString” value-"ECG"» 
«/decision» 
</conditions> 


</саһев> 


Using the XML, a CLIPS rule is generated automatically. The code 
snippet that generates the CLIPS rule is as follows: 


public static void write () 


File file = new File( ruleName + ".clp"); 
// if file does not exists, then create it 
System.out.println(" Writing rule file ..."); 


гу { 
file.createNewFile(); 
FileWriter fw = new FileWriter(file.getAbsoluteFile()); 
BufferedWriter out = new BufferedWriter(fw); 
out.write("(defglobal ?*"-- ruleName +"DecisionString™ = (create$))"); 
out.write("(deftemplate " + ruleName +"_message\n\t(slot "+ 
decisionName[0] +")\n)"); 

out.write("(deftemplate " + ruleName +"_data\n") 
List<String> uniqueVars=new ArrayList<String>(); 
int ind=0; 

for(int j=0;j<cnlength;j++) 


for(int i=0;i<gdinQuestions[j].length;i++) 

i 
uniqueVars.add(ind, varNamesArr[j][i]); 
if(!gdlnQuestions[j](i].equals("null")) 4 

out.write("(slot "+varNamesArr{j][i] + ")\n"); 
} 
> 
out.write(")\n\n"); 


out.write("(defrule print message " + ruleName + "\n"); 
out. write("\t("+ruleName+"_message("+decisionName[0]+" ?a))\n" ); 
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out.write(" =>\n\t(bind ?*"+ ruleName +"DecisionString* (create$ ?*"+ ruleName 
+"DecisionString* ?a))\n)\n\n"); 
for(int j=0;j<cnlength;j++) 
қ out.write("(defrule " + ruleName + " " + conditionsName[j] + "\n"); 


if(isOrPresent{j] == true) ( 
out.write("(or\n"); 


} 
for(int i=0;i<gdinQuestions[j].length;i++) 
if(!gdlnQuestions[j][1].equals("null")) { 


out.write("(" + ruleName +"_data("+varNamesArr{j][i] + " " 
+ anStrings(j)(i] + "))\n" ); 
} 


} 


if(isOrPresent{j] == true) { 
out.write(")\n"); 


out.write("=>\n (assert ("+ ruleName +"_message(" + decisionName[j] + " 
V" + decisionValue[j] + "\"))))\n\n"); 
} 


out.close(); 
System.out.println("Done"); 
} 


CLIPS Rules File Corresponding 
to Knowledge 


The reader is advised to go through the CLIPS basic programming guide to 
get a good grasp of CLIPS rules syntax [23]. 


(defglobal ?*Chief Complaint Chest Pain DecisionString* = 
(create$)) 
(deftemplate Chief Complaint Chest Pain message 
(slot decisionString) 
) 
(deftemplate Chief Complaint Chest Pain data 
(slot pain exertion) 
(slot pain radiate neck jaw arms) 
(slot pain squeezing tightness quality) 
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(slot it accompanied shortness breath sweating feeling 
clamminess nausea indigestion) 
(slot If pain anginal nature 1% last more than 15 30. 
minutes) 
(slot Can pain be reproduced movement arms torso 
pushing certain area chest) 
(slot pain made worse deep breathing) 
(slot pain brought eating lying down it relieved | 
antacids) 

) 

(defrule print message Chief Complaint Chest Pain 
(Chief Complaint Chest Pain message(decisionString ?a)) 


=› 
(bind ?*Chief Complaint Chest Pain DecisionString* 
(create$ ?*Chief Complaint Chest Pain DecisionString* 
?a)) 

) 

(defrule Chief Complaint Chest Pain EKG 

(or 


(Chief Complaint Chest Pain data(pain exertion yes)) 

(Chief Complaint Chest Pain data(pain radiate neck jaw arms yes)) 
(Chief Complaint Chest Pain data(pain squeezing tightness | 
quality yes)) 

(Chief Complaint Chest Pain data(it accompanied shortness | 
breath sweating feeling clamminess nausea indigestion yes)) 
(Chief Complaint Chest Pain data(If pain anginal nature it 
last more than 15 30 minutes yes)) 

) 

=> 

(assert (Chief Complaint Chest Pain message(decisionString 
"EKG"))) 


) 
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(defrule Chief Complaint Chest Pain No Test 

(Chief Complaint Chest Pain data(pain exertion no)) 

(Chief Complaint Chest Pain data(pain radiate neck jaw arms no)) 
(Chief Complaint Chest Pain data(pain squeezing tightness | 
quality no)) 

(Chief Complaint Chest Pain data(Can pain be reproduced | 
movement arms torso pushing certain area chest no)) 

(Chief Complaint Chest Pain data(pain made worse deep | 
breathing no)) 

(Chief Complaint Chest Pain data(pain brought eating lying | 
down it relieved antacids yes)) 

(Chief Complaint Chest Pain data(it accompanied shortness | 
breath sweating feeling clamminess nausea indigestion no)) 
(Chief Complaint Chest Pain data(If pain anginal nature it 
last more than 15 30 minutes no)) 

-> 

(assert (Chief Complaint Chest Pain message(decisionString 
"No Test"))) 

) 

(defrule Chief Complaint Chest Pain chest x-ray 

(or 

(Chief Complaint Chest Pain data(Can pain be reproduced | 
movement arms torso pushing certain area chest yes)) 

(Chief Complaint Chest Pain data(pain made worse deep 
breathing yes)) 

) 

-> 

(assert (Chief Complaint Chest Pain message(decisionString 
"chest x-ray"))) 


) 
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Knowledge Processing by Application 


When the user selects the "chest pain" guideline in the knowledge 
application, a set of questions is presented (Figure 8-2). When the user 
answers the questions, a context manager constructs a CLIPS assert 
string and asserts it to the rules engine. The generated CLIPS rules files 
are already loaded into the rules engine at the time of application startup. 
The rules engine comes up with the result based on the rules files and 
user input. The context manager then reads the result back from the rules 
engine and sends it to the main activity for display. 


Knowledge Application Supporting-Feature 
Generation 


From the information present in the registration and settings files 
(Figures 8-3 and 8-4), SmartAppGen automatically generates a 
corresponding Android layout and activity file for the application. 


registration regl 

field-text field-type field-subType field-value default-value 
Patient's Age: EditText numeric = 

Patient's Weight: EditText numeric 

Select Gender Spinner Prefer not to say:Male:Female Prefer not to say 
Area Name: EditText text um 

Pin Code: EditText Numeric m 


Figure 8-3. User registration information 


settings MainSetting 


field-text field-type field-input field-value default-vifield-editabl field-maxlength 
Server IP EditText Phone Default 10 
Select Language Spinner English:Hin English 10 
Language Selected  EditText FALSE 10 
Asha registration EditText 10 


Figure 8-4. Knowledge management app settings 
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Figures 8-5 and 8-6 show the generated app. 


Patient's Name 


Patient's Weight: 


Select Gender 





Figure 8-5. Generated Registration screen 


Server ІР 
Default 


Select Language 





Asha registration Number 


Figure 8-6. Generated Settings screen 
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Generate Database Helper 


SmartAppGen can also generate a database helper class automatically. 


The database helper class is required to persist application information. 


Database settings are depicted in Figure 8-7. 


database example! woman :configuration:pk 
field-name field-type field-null 
woman а 
id varchar(60) not null 
Wname varchar(40) not null 
Wage int(2) not null 


update=WName:WaAge, detail=WAge, WName:Weight prune=WAge<20 


configuration Component 


Component varchar(50] not null 
version varchar(40) not null 
update = version detailzversion 


Figure 8-7. Knowledge application database settings 


Here is a snippet ofthe generated database helper: 


public class example1 DataHelper { 

private static final String DATABASE NAME = "ехатр1е1 
private static final int DATABASE VERSION - 4; 
private static final String TABLE REG1 = "тері"; 
private Context context; 

private SOLiteDatabase db; 

public ехатр1е1 DataHelper(Context context) 5 
this.context = context; 

OpenHelper openHelper - new OpenHelper(this.context); 
this.db - openHelper.getWritableDatabase(); 

} 


public long insert regi(String values) 

{ 

long returnValue = 1; 

String executeString = "insert into " + TABLE REG1 + 
(" + values +"); "; 


ША 
2 


values 
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Log.d(" insert" ,executeString); 


try { 
db.execSOL(executeString); 
) 


catch(SOLiteException е) { 

Log.e("Database error while inserting",e.toString()); 
returnValue - 0; 

} 

return returnValue; 

} 

public long update regi(String pk, String Age, String Weight, 
String Gender, String Area, String Pincode) 

{ 

long returnValue = 1; 

String executeString = "update " + TABLE REG1 + " set "+ 


"Age = н * Age + Ы + "Weight = н + Weight + S 4 
"Gender = '" + Gender + "'," + "Area = '" + Area + "'," + 
"Pincode = '" + Pincode + "'" + " where Id = '" + pk + "' 5'5 


Log.d(" update" ,executeString); 


try { 
db.execSQL(executeString) ; 
} 


catch(SQLiteException e) { 
Log.e("Database error while updating",e.toString()); 
returnValue = 0; 


) 


return returnValue; 


} 
public String getName regi(String pk) 


{ 
String str = 


86 


CHAPTER 8 EXAMPLE OF GENERATING KNOWLEDGE APPLICATION FROM KNOWLEDGE 


Cursor cursor = this.db.query (TABLE REG1, new String[] 
{"Name"}, "Id" + "="+"?", mew String[]{pk}, null, null, "ID 
desc"); 

if (cursor.moveToFirst()) 


{ 


str = cursor.getString(0); 

} 

if (cursor !- null 88 !cursor.isClosed()) { 
cursor.close(); 


) 


return str; 

} 

public void deleteAll regi() 

1 

this.db.delete(TABLE REG1, null, null); 

) 

public List<String> selectAll гер1() 

{ 

List<String>list = new ArrayList<String>(); 
Cursor cursor = this.db.query (TABLE REG1, new String[] 
( "Id" ), null, null, null, null, "ID desc"); 
if (cursor.moveToFirst()) ( 

do { 

list.add(cursor.getString(0)); 

} while (cursor.moveToNext()); 

} 

if (cursor !- null 88 !cursor.isClosed()) { 
cursor.close(); 


) 


return list; 


) 


87 


CHAPTER 8 EXAMPLE OF GENERATING KNOWLEDGE APPLICATION FROM KNOWLEDGE 


public void prune(String tableName, String condition) 


{ 


String sql="delete from "+ tableName + " where 


+ condition; 
db.rawQuery(sql, null) .moveToFirst(); 


} 
public void pruneAll(String[] tableName, String[] condition) 


{ 

for(int i=0;i<tableName. length; i++) { 
prune(tableName[i],condition[i]); 

} 

} 


private static class OpenHelper extends SOLiteOpenHelper { 
OpenHelper(Context context) { 

super(context, DATABASE NAME, null, DATABASE VERSION); 
}@Override 

public void onCreate(SQLiteDatabase db) { 

try { 

String execStr; 

execStr = "CREATE TABLE " + TABLE REG1 + " (Id varchar(60) not 
null, Name varchar(60) not null, Age int(3) not null, Weight 
int(3) not null, Gender varchar(60) not null, Area varchar(60) 
not null, Pincode int(6) not null, PRIMARY KEY (Id) )"; 
Log.d("example1 DataHelper \n",execStr) ; 

db.execSQL(execStr) ; 

jcatch(SOLiteException e) { 

Log.e("Database error",e.toString()); 

) 

) 


QOverride 
public void onUpgrade(SOLiteDatabase db, int oldVersion, int 
newVersion) { 
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Log.w("Example", "Upgrading database, this will drop tables and 
recreate."); 

db.execSOL("DROP TABLE IF EXISTS " + TABLE REG1); 

onCreate(db) ; 

) 

) 

) 


How to Use SmartAppGen 


Create a new Android project and provide main Android layout, main 
activity Java file, AndroidManifest.xml, Excel sheet/text file containing 
knowledge, and application configuration as runtime argument to 
SmartAppGen and run it. All codes get generated and copied along with 
reusable frameworks developed as part of SmartAppGen to the Android 
project. Just refresh the project and do a clean build and run it. Your 
knowledge application is ready for deployment. 


Benefits of SmartAppGen 


The following benefits can easily be observed: 


e The SmartAppGen accelerator frameworks will 
significantly reduce time to develop any knowledge 
applications by 30 to 50 percent. 


e The generic frameworks (audio capturer, text to speech, 
photo capturer, upload manager, rules updater, etc.) 
can be reused in any Android project. 
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СНАРТЕК 9 


AutoQuiz: 
Automatically 
Generate Quiz 
from Unstructured 
Knowledge 


In this chapter, we will show how to automatically build a quiz application 
from knowledge using natural language processing (NLP) techniques. NLP 
provides a way to process, understand, and derive meaning from human 
language. Apple's SIRI, Google's Home, Amazon's Echo, and Microsoft's 
Cortana are few examples of NLP systems. 

To validate a user's learning from a training, he or she needs to 
undergo a test corresponding to the training material and score above a 
threshold decided by the company or institute. 

One of the most time-consuming aspects of such testing is the generation 
of questions. They usually have to be constructed manually by experts in 
the subject. Furthermore, the validation of answers is time-consuming too, 
depending on the nature ofthe questions and the number of users. 
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AutoQuiz solves this problem by automating the generation of 
questions. We extract the knowledge from the training materials and then 
validate the users' learning by presenting them with the quizzes. 

AutoQuiz accepts text-based training material as input, which serves 
the purpose in most cases, since text can be easily extracted from various 
types of documents like PPT, PDF Word doc, and so forth and fed into the 
AutoQuiz knowledge-management system. 

The AutoQuiz system has two components: the question generator and 
the knowledge application that displays the quiz and the score of the user. 


Question Generator 


It takes a text-based article in a .txt file and outputs an XML file containing 
the questions, answers, options, and so forth. Upon initiating the 
program, the user enters the file name of article (including pathname if 
not in current directory). The program uses the Stanford NER (Named 
Entity Recognition) tagger to tag words ofthe following categories: Time, 
Location, Organization, Person, Money, Percent, and Date. 

The program then uses the Stanford POS (Part of Speech) tagger [16], 
v.3.2.0, which is open source. It uses the API of the Penn Treebank tag 
set [20] to tag words according to their POS. It uses 60-200 MB to run a 
trained tagger with this API, which is fairly low compared to other taggers 
like OpenNLP [17], which uses about 3-4 GB to run, with the trainer 
provided by default. However, Ореп МІР also provides other tools, like 
sentence segmentation and named entity extraction, which are not 
supported by the Stanford POS tagger but that would be useful to our 
application. After tagging the words, the tagged words are stored in a text 
file, from which each sentence is parsed and converted into one of four 
different types of questions: 
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e Keyword questions: These are "fill in the blank" 
questions where there are no options and the right 
answer is a keyword from the sentence. This keyword 
is a proper noun detected by the POS tagger. Generally, 
proper nouns are good keywords, because they are 
usually the subject of the sentence. An extension would 
be to use the OpenNLP tools to detect the head of the 
sentence and make that the keyword. 


e Noun questions: This is another "fill in the blank" 
question where nouns are detected via the POS tagger 
but options are provided for the answer. Options are 
nouns from other sentences. A key factor in the quality 
of these questions is the sense and relevance of the 
questions and options. We plan to provide options with 
attributes and scan through the pool of all answers to 
look for the same attribute when selecting the options. 
For example: 


Input sentence: 


e “Ар Engineer is trying to develop lightweight, ‘air 
breathing’ hypersonic vehicles that can travel at rocket- 
like speeds while taking oxygen from the atmosphere.” 


Noun: engineer 
Attribute: profession 


• Weuse WordNet [18] to find its siblings in a tree 
of professions; for example, scientist, electrician, 
technologist, and so forth. 


e Investigative questions (first kind): These are questions 
that are of an investigative nature; for example: 
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Input sentence: "Jake was the one who took the саг” 


Question: "Who was the one who took the car?" 


е These questions look for verbs in the third person, past 
tense. This is because most descriptive articles use 
sentences in the third person past tense. In addition, 
the answer must contain a proper noun to avoid trivial 
cases like: "It was lying on the table.” 


Without this rule, the answer would be “It,” which is nota 
meaningful question. 


"Who/what" questions can be refined to be either who or what 
(or even when, how much, and so forth) using named entity 
recognition software, for example, Stanford Named entity 
recognizer [21], or OpenNLP tools [17]. 


e Investigative questions (second kind): These questions 
are similar to investigative questions of the first kind. 
Instead of starting with the questioning words, they end 
with the questioning words. For example: 


Input sentence: "Jake was the one who took the саг” 


Question: "Jake was the one who took the what?" 


Similarly, a named entity recognizer can be used to refine the 
wording of the questions. 


These questions are stored in an XML file under the following format: 


«questions guideline-name-Quiz name» 

«question» 
«question-text»question«/question-text» 
«answer-type»RadioButton/Text«/ answer-type» 
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<answer-value>answer</answer-value> 
«option-value»optioni:option2...«/option-value» 
«/question» 
«question» 


This XML file is stored in the second project—the Android application 
project. The exact location is a user input to the first project. The field 
is encrypted using a simple variation of the Caesar cipher: in the ASCII 
table, all the characters are shifted by a certain index. This would prevent 
the visibility of the answer if a user decided to extract the files from the 
installed application. 


Quiz Application 


The application reads the XML files and creates a separate quiz for each file. 
The user can determine the number of questions per page. A progress bar 
indicates what fraction of the quiz has been completed. At the end, the user 
is given his or her score for that quiz. The screenshots in Figures 9-1 to 9-3 
will help you better understand the application workflow. 
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Welcome to AutoQuiz!! - Д 


Policies Quiz 


Economist Article Quiz 





Figure 9-1. AutoQuiz application 
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BMB 1:59ғм 


Quiz 


@ о» 
о 


10) Who/what be kept away from 
the wall of the combustion 
chamber? 


Carried by Rafale and Mirage fighter 
jets, they are thought to 


But reaching hypersonic speeds of 
Mach 5 and above with an air- 
breathing engine means getting 
combustion to 


б Scramjet fuel must also 


Figure 9-2. Quiz questions 
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gam) ӨЗ 2:15 om 


You scored 84.6196, 


(11/13). 


Back to main screen 





Figure 9-3. Quiz score 


Benefits of AutoQuiz 


We can easily observe the following benefits of the AutoQuiz system: 


e Automatically generate quizzes based on training/ 
presentation materials, saving hours of effort to prepare 
quiz manually 


e Automatically validate quiz answers, again saving 
hours of effort to validate answers manually 


e Makes training/presentation more effective, as 
people attending training would have to answer quiz 
generated by AutoQuiz, and they and their manager get 
to know the score immediately 


e Measure effectiveness of trainer and training materials 
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Known Issues 


We still need to resolve the following issues for AutoQuiz system: 


In the “fill in the blanks” and “nouns” questions, the 
options may not always make sense, making it easy for 
the test taker to answer the question correctly without 
having knowledge of the article. We intend to tackle this 
problem by tagging the words in the options-pool with 
attributes. 


Investigative questions of both kinds can become too 
monotonous and robotic if they only use who/what. 
These are used because of AutoQuiz’s inability to 
recognize the subject in the sentence. 


Focus of sentence: The current prototypes are unable 
to recognize the subject of the sentence and give more 
meaningful questions. For example: 


Input sentence: "Only the thief wears a black hat.” 


Here, the focus is on “thief” and not, say, the color of 
the hat. 


Suitable question: “Who wears a black hat?” 


Less suitable question: “What color hat does the 
thief wear?” 


Extracting knowledge: The current prototypes only 
extract knowledge on a high level and not in detail. 
They do not use rules to store the knowledge, so they 
cannot be used to make derivations. For example: 
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Input: 


‘Joe is the brother of John. John is the brother of 
Jake.” 


Possible derivation: “Joe is a brother of Јаке” 
We present possible solutions to these issues in the next section. 


Future Work 


Named Entity Recognition software can be used to refine the “who/what” 
questions to be more specific. This would aid in adding clarity for the user 
and would also improve the quality of the questions. This data can be used 
to highly specialize questions; for example, who, what, when, how much, 
and so forth. Furthermore, it would also aid in recognizing the head of the 
sentence. 

Another refinement that could be made is allowing the person creating 
the quiz to select the sentences for which to generate questions, rather 
than using every sentence. A key criterion could be the presence of words 
with a particular POS that is crucial to the question. 

Furthermore, compound sentences could either be split into two 
separate sentences or be used as questions and answers. For example: 

Input sentence: 


“Joe went to the kitchen because he was hungry.” 
(“Joe went to the kitchen.”) + (“He was hungry") 
Possible questions: 

“Who went to the kitchen?” 

“Who was hungry?” 


“Why did Joe go to the kitchen?” (Answer: “because 
he was hungry”) 
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However, questions like these require a greater understanding of the 
sentences by the program. A first step would be to parse the sentence in 
such a way that we can recognize the head and the body of the sentence. 
The OpenNLP parser can be used to determine the structure of a sentence. 
For example: 

Input sentence: “The quick brown fox jumps over the lazy dog.’ 

Output: 


(TOP 

(NP 

(NP 

(DT The) 
(JJ quick) 
(JJ brown) 
(NN fox) 
(NNS jumps) 
) 

(PP 

(IN over) 
(NP 

(DT the) 
(JJ lazy) 
(NN dog) 
) 

) 

(. -) 


PP, IN, JJ, etc. are the POS tags from the Penn Treebank tagset [20]. 
Sentences parsed in this way can aid in computers’ understanding of the 
structure of the sentence and help them generate questions that are more 
inventive than simply manipulating the original sentence. 
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Furthermore, sentences parsed in this way can aid in extracting the 
knowledge from the sentence. Knowledge can be stored in the form of 
rules (for example, CLIPS [19], which is a rules engine). These rules can act 
as predicates that can be used to derive conclusions. These conclusions 
will be stored as new rules, and they can also be output as questions. 

Knowledge-management automation needs to be planned by 
corporates. "Knowledge application" can be automatically generated from 
the available structured knowledge. Such application can help knowledge 
workers perform their daily job better. This would significantly reduce the 
time needed to train people and increase the efficiency and accuracy of 
the knowledge workers. 

When training employees on unstructured knowledge, companies 
continue to spend millions of dollars; many ofthe trainings are not 
effective and waste those dollars. Implementing AutoQuiz can ensure 
that employees actually understand the knowledge shared in a training 
or presentation. Project managers can assess the effectiveness of the 
training or presentation (for example, which training is redundant, which 
employee is a slow learner, which trainer is not effective, and so forth) and 
take appropriate action. 
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ІЕтегделсу 


In most of the developing world, if a person faces an emergency situation— 
like getting mugged, being beaten, getting molested, getting lost in an 
unknown place, meeting with an accident, needing a safety guide, and so 
on—there is hardly any help available. The longer the person stays in the 
emergency situation, the more the probability of losing life or belongings 
increases. In countries like India, the ratio of people to police personnel is 
125:100000, and the roads are heavily congested with traffic during peak 
hours. Hence, most of the time police are unable to attend to the crime 
quickly. It generally takes more than two hours for the police to reach 

the crime scene! Also, it has been observed that the common public is 
either not interested or too afraid to provide emergency help to the needy, 
fearing attack by the culprits. This results in major physical, emotional, and 
economical damage to the victim, and may even lead to death. 

The proposed system, iEmergency, aims to provide on-the-spot 
emergency help to victims via a network of registered emergency help 
providers. The victim can initiate a request for emergency help using 
their smartphone. The mobile network finds nearby emergency help 
providers using location-based services and notifies them. Emergency 
help providers reach out to the victim and provide required assistance. On 
completion of the help to the satisfaction of the victim, a fixed amount of 
money is deducted from the victim's account and distributed among the 
emergency help providers who responded to the request and provided 
help on the spot within the specified timeframe. 
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Method 


When a person is facing an emergency situation, he or she can initiate a 
request for emergency help using the application installed in his or her 
smartphone. The requester needs to choose the type of emergency help 
required. The emergency situation details along with the requester's 
location (e.g., GPS/GPRS) are uploaded to the iEmergency server. A person 
can select and register for various types of emergency services depending 
upon his or her capabilities. For example, a person residing near a highway 
can register as an accident relief service provider, retired military or police 
personnel can register themselves as petty crime-prevention service 
providers, social service-minded persons can register as companions for 
hospital trips, and so forth. The server identifies the emergency helper(s) 
available within a specified radius from the location of the requester who 
match the type of help that he or she is looking for. The server determines 
the number of emergency helpers required for the type of emergency faced 
by the person and sends details about the emergency and the requester 
(name, location, and photo) to the emergency helper(s). Emergency 
helper(s) receive a message such as "Mr. «name» «mobile number» is 
facing emergency situation of type «type» at «location»? The emergency 
helper can visualize the requester's current position on the map. The 
emergency helper(s) can either accept or reject the service request. 

If an emergency helper accepts the request, he or she can retrieve 
the audio/video file(s) associated with the requester and gather more 
information about their location and type of emergency. The requester 
side ofthe application has the ability to upload audio or video files. He or 
she may record an emergency message and upload the audio to the server 
so it can be downloaded by the helper. The emergency helper tries to 
come as near as possible to the requester's location and either shouts the 
name of the person or calls him or her using the mobile phone. The server 
periodically receives location details of the available emergency helper(s) 
so that, in case of any emergency event, the server knows their location. 
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Architecture 


The architecture of the proposed system with a high-level work flow is 
illustrated in Figure 10-1. The system consists of Requester and Helper 
applications and a centralized server. The requester sends a request for 
emergency service by starting the Requester application installed on 

his or her Smartphone. The application sends a request to the server 

to send helpers to the spot. The server notifies nearby helpers about 

the emergency. The helpers reach the spot and provide requester with 
required service. The requester then proceeds to pay the helpers. The 
server responds back with the list of helpers who had accepted the request. 
The requester identifies the helpers from the list to select the helpers who 
actually came to help, and the requester pays those helpers (Figure 10-6). 
The payment server authenticates the requester and sends payment to the 
helper. 

The Helper application scans for requests from nearby requesters. The 
server retrieves details of the person waiting for help in the vicinity of the 
helper and sends the details in response. The Helper application displays 
the requester as well as helper on a map. The helper accepts or rejects the 
request. The helper helps the requester and, after receiving the payment 
notification, he or she marks the job complete and provides feedback 
(Figure 10-7). 
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Figure 10-1. iEmergency architecture 


Implementation of the System 


The system consists of Requester (iRescue) and Helper (iRescuer) Android 
applications, used by the requester and helpers respectively, and a 
centralized server. Any individual can register on the portal as a requester 
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and/or a helper. At the time of registration, the person has to provide 
details such as mobile number that will be used for the service, recent 
photograph, and email ID as well as upload copies of identity and address 
proof. The submitted information will be verified either automatically 
(mobile number and email ID) or manually (address) to ensure that the 
helpers are genuine persons. Help from law enforcement authorities may 
be sought for manual verification of the helpers. 


Requester Application iRescue 


This application is installed on the requester's mobile phone. When he or 
she faces an emergency situation, he or she starts the application, enters 
a PIN, and records his or her voice to provide more details about the 
emergency faced. Details of the emergency situation and related audio 
or any media file(s) are uploaded to a central server HTTP POST request. 
In addition to that, when the server finds that a helper associated with 
the requester has reached within an audible distance, the application 
starts beeping loudly. When the helper reaches the person and provides 
the required emergency service, the application retrieves the list of 
helpers who had accepted the request and displays it to requester. The 
photo, name, and mobile number of the helpers are displayed in the 
application. The requester can choose one or more helpers from the list 
and authenticate payment. Feedback can also be left for the helpers. The 
feedback for the helpers is uploaded to the server. 


Helper Application iRescuer 


This application is installed on the helper's mobile phone. By using 
location-based services (LBS), it periodically sends the helper's location 
information to the server. It retrieves details of the nearest requester 
waiting to receive emergency help. It shows the helper as well as the 
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requester on a map. It also displays the current distance of the requester 
from the helper. The helper can either accept or reject the request. If the 
request is rejected, the server updates the record of helper. If the helper 
decides to accept the request, further details of the person in need (name, 
mobile number, and photo) are displayed. The helper can also download 
any audio associated with the requester and play it to gather additional 
information about the emergency. 

Once the helper reaches the requester, provides emergency service, 
and receives payment, he or she marks the job as complete in the 
application and provides feedback on the requester. 


User Interface 


Some ofthe main screens ofthe iRescue and iRescuer applications have 
been depicted in Figures 10-2 to 10-7, which display the different type 
of emergencies that the iEmergency system supports. As an example, 
Figure 10-5 displays a map where both helper and victim are plotted. 
Figure 10-6 displays a photo of the requester, and Figure 10-7 displays 
photo and details of helpers who actually provided the service. 


108 


CHAPTER 10 IEMERGENCY 


pe of Emergency? 
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Other Emergency 
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Exit 





Figure 10-2. iRescue type of emergency 
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Your GPS co-ordinates 
Latitude:12.852414 
Longitude:77.664116 


Waiting for call... 


Settings 


Figure 10-3. iRescuer waiting 
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Distance from Victim (meters): 124 





Figure 10-4. iRescuer accept/reject 
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ictim Details 


Мате: Коску 

Mobile Мо: 1234567890 
Latitude:12.849873 
Longitude:77.665217 


Download Audio 


Job Complete 


Abort Rescue 





Figure 10-5. iRescuer victim details 
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m Select All 


9876543210 


9876540123 





Figure 10-6. iRescue payment 
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ob Complete 


Feedback: 





Figure 10-7. iRescuer job complete 


iEmergency Server 


The iEmergency server is built on top of the Apache XAMPP platform. It 
consists of one Apache server and one MySQL server. The server receives 
various requests from helper(s) and requester(s) via HTTP POST and HTTP 
GET and sends HTTP responses to both iRescue and iRescuer applications. 
It maintains various details of registered requester(s) and helper(s). The 
server sends nearby victim details to the iRescuer application. It also stores 
audio details of the requester and allows the helper to download the audio. 
In addition to that, feedback for the transaction between requester and 
helper is recorded in the server. 
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for Solving Real-Life 
Problems 


СНАРТЕК 11 


Assignments 


This chapter contains multiple assignments that will test what you have 
learned from previous chapter. 


ІЕпсгурї and iDecrypt 


Come up with two android applications— say, iEncrypt and iDecrypt. 
iEncrypt will take a password and image file to encrypt and the type of 
context/rule to be added while encrypting. 

The following screenshots (Figures 11-1 to 11-5) will help you 
understand the application requirements. 
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Mobile Number: 


9811098110 


М Code 

560000 
Latitude: 

12.849758 


Longitude 


77.665228 





Figure 11-1. iEncrypt setting 
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Submit 


Settings 





Figure 11-2. iEncrypt input 
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Mobile Number: 
9911199111 

IP Address: 


10.76.6.145 


77.665217 


Save Cancel 


Figure 11-3. iDecrypt setting 
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Settings 





Figure 11-4. iDecrypt input 
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Figure 11-5. iDecrypt decrypted content 


iFitness 


Many times, when a user is exercising—for example, running on a 
treadmill—he or she either runs too slow or runs too fast, making the 
workout ineffective or harmful. 

Develop an Android application to help the user measure the 
effectiveness of his or her fitness program. Let the user wear a strap 
(Figure 11-6) that transmits vital parameters, like number of steps, 
speed, heart rate, and so forth, to an Android application over Bluetooth. 
Configure the exercise mode as depicted in Figure 11-7). 
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Figure 11-6. Zephyr strap 





FAT BURN 


JUST GO 


1 





SETTINGS 


| 


Figure 11-7. iFitness main screen 


In the settings, configure upper and lower thresholds of speed for each 
of the categories. For example, "FAT BURN" speed can be between 10 and 
20 km/hour. Also define what is considered the "above normal" threshold 
for heart rate. In addition to that, advise the user based on his or her 
speed and selected exercise mode. Also, advise the user to stop exercising 
immediately if his or her heart rate crosses the upper threshold defined. 


iPocket 


The pick-pocketing of mobile phones is a huge menace in developing 
countries, and even developed countries like Spain, Italy, and France are 
severely affected by it. Millions of mobile phones are lost every year due 


123 


CHAPTER 11 ASSIGNMENTS 


to pick-pocketing. How can we detect a phone getting pick-pocketed in 
real-time? 

When someone pick-pockets a phone, the accelerometer data pattern 
is significantly different than that of the pattern that occurs when a person 
picks his/her phone from pocket for making/receiving calls. Develop an 
Android service to monitor the accelerometer pattern. Identify the pick- 
pocketing pattern by collecting 10-12 data points any time phone is picked 
up and comparing the accelerometer data with the normal as well as the 
pick-pocketing data points. 


iFall 


Elderly people often fall down, and it can happen while they are home alone; 
they can even fall unconscious following the fall. Can an Android application 
detect such emergencies and inform a concerned emergency contact? 
Collect 10-12 accelerometer readings when a person falls down with a 
phone inside his or her pocket as well as in his or her hand. Run a service 
in the phone to check for such accelerometer patterns. When a similar 
pattern is detected, wake up the iFall Android application and ask the 
user, "Are you Okay?" If the user says yes, the application exits; otherwise, 
the application retries to get a response from user. If no response is 
received, the app sends a text message with location, time details, and a 
message like "User seems to have fallen down, not responding for past X 
minutes" to preconfigured mobile numbers. The mobile numbers must be 
configured using the settings of the iFall application. 


iPrescribe 


Patients often forget to take medicine on time. Also, once the symptoms 
subside, patients stop taking their medicines altogether, due to which they 
do not recover completely and may fall sick again. 
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Feed the prescription along with the dosing schedule into the 
iPrescribe application. Remind the user, saying things like, "It's 9 p.m., 
please take 1 crocin tablet, and also take 1 teaspoon of zedex syrup at five 
past 9 p.m.” After a configurable number of minutes, the application will 
ask the patient, "Did you take medicines as prescribed?" The patient can 
answer "yes" or "no"; if the patient says “no,” iPrescribe will ask them the 
reason for not taking the medicine, then it records the reason and stores it 
along with the prescription schedule. 

Atthe end ofthe schedule, the data can be uploaded to a central server 
and analyzed for studying the effectiveness of the medicines prescribed. 
iPrescribe should also be able to come up with a health negligence 
quotient for the patient based on how religiously they followed the 
prescription schedule. 

Think about whether prescriptions could be fed into the iPrescribe 
Android application automatically. 


iSafety 


In developing countries, crimes against children (on the way to school/ 
home) have increased significantly in recent years. How can we ensure the 
safety of kids and family when they are out from sight? 

Develop a safe-zone application and install it on the child’s phone. 
Configure safe zones, like school, home, and so forth. If the person 
happens to stay out of a safe zone for more than a configurable number of 
minutes, start sending SMS along with GPS location details of the person 
periodically. The person receiving the SMS and location details can plot 
the locations in a map and determine a further course of action. 

In this chapter, we learned how to design and develop a complete 
system using Android applications and a backend server to solve real-life 
problems. We also hope that after going through the problems, readers will 
be able to come up with new Android project ideas. 
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